home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 1998 June / Software of the Month Club 1998 June.iso / mac / Business / Hi's Universal Saver / Menu Events 1.3 / Menu Events Help / Menu Events Help.rsrc / STR#_1030.txt < prev    next >
Encoding:
Text File  |  1998-04-13  |  6.4 KB  |  319 lines
  1. 
  2.  
  3. 
  4.  
  5. l
  6.  
  7. l
  8.  
  9. åLimitations
  10.  
  11. 
  12.  
  13. 
  14.  
  15. Some applications refuse to submit to the trickery of Menu Events.  The
  16.  
  17. prime example is any version of Finder which predates the Power
  18.  
  19. Macintosh (version 7.1.2).  It is not truly an Apple event server, and it
  20.  
  21. only respects events of known types.  Any other high-level event is not
  22.  
  23. replied to, and the send will time out.  ResEdit 2.1.1 is similar.  Some
  24.  
  25. Microsoft applications handle Apple events in a non-standard fashion,
  26.  
  27. binding their own event handlers over all Apple event classes, and
  28.  
  29. therefore should not be targeted.
  30.  
  31. 
  32.  
  33. 
  34.  
  35. The only way to know for sure is to try the ones you are interested in
  36.  
  37. controlling.  Certainly, anything you write yourself is a candidate, as long
  38.  
  39. as you follow the practices suggested in Apple documentation, namely:  Be
  40.  
  41. high-level-event-aware.  Always be ready to accept and dispatch an
  42.  
  43. Apple event.  Assume that any high-level event you donΓÇÖt recognize is an
  44.  
  45. Apple event, and dispatch it as such.  If an unknown event reaches your
  46.  
  47. wildcard event handler, return errAEEventNotHandled, so that system
  48.  
  49. event handlers can get a crack at it.  DonΓÇÖt deny other programs on the
  50.  
  51. same machine the right to request user interaction, which is the default.
  52.  
  53. 
  54.  
  55. Another limitation you should know about is that Menu Events canΓÇÖt
  56.  
  57. operate dialogs and alerts which the target application may post in
  58.  
  59. response to the menu action.  If the menu item text ends in an ellipsis
  60.  
  61. ('ΓǪ') character, you can bet that the application will post a dialog or alert
  62.  
  63. box.  It is then up to the local user to operate the controls.
  64.  
  65. 
  66.  
  67. If the target machine is under the influence of a screen saver or security
  68.  
  69. package which would present a modal dialog in response to a mouse click,
  70.  
  71. then Query Menu and Select Menu Item events will time out.  The same is
  72.  
  73. true if the target machine is already showing a modal dialog, preventing
  74.  
  75. Menu Events from activating the target application.
  76.  
  77. 
  78.  
  79. A known conflict exists between Menu Events and Help on Wheels.  If you
  80.  
  81. send a Menu event to an application which does a casual help display
  82.  
  83. before performing the menu action, and if the help server is running,
  84.  
  85. problems may occur with the application.  The problem is that the Menu
  86.  
  87. eventΓÇÖs user interaction ends when the receiving application sends an
  88.  
  89. Apple event to the help server, causing it to return to the background.  If
  90.  
  91. the menu action causes a call to the Standard File Manager or any other
  92.  
  93. code which should not be called when in the background, the application
  94.  
  95. may hang.
  96.  
  97. 
  98.  
  99. 
  100.  
  101. 
  102.  
  103. 
  104.  
  105. ΓÇô
  106.  
  107. ΓÇô
  108.  
  109. ├ÑProgrammer Notes
  110.  
  111. 
  112.  
  113. 
  114.  
  115. Write to the author at the above address if you want to know more about
  116.  
  117. the Menu Events extension or how it was programmed.
  118.  
  119. 
  120.  
  121. 
  122.  
  123. 
  124.  
  125. 
  126.  
  127. 
  128.  
  129. 4
  130.  
  131. 4
  132.  
  133. åAcknowledgements
  134.  
  135. 
  136.  
  137. 
  138.  
  139. Thanks to C.K. Haun and the other folks at Apple Developer Technical
  140.  
  141. Support who put together those clever little code snippets which give
  142.  
  143. folks like me such odd ideas.
  144.  
  145. 
  146.  
  147. 
  148.  
  149. Special thanks to the many fine people who beta-tested this software,
  150.  
  151. including Ken Linger, Chris Reynolds, Michele Marques, Chris Kaltwasser,
  152.  
  153. James Edward Davis, and Leonard Rosenthol, and to Fred Terry for his
  154.  
  155. hospitality at the MacScripting mailing list.
  156.  
  157. 
  158.  
  159. 
  160.  
  161. 
  162.  
  163. 
  164.  
  165. ├▓
  166.  
  167. ├▓
  168.  
  169. ├ÑRevision History
  170.  
  171. 
  172.  
  173. 
  174.  
  175. Click on any underlined item in this listing to read more about the revision
  176.  
  177. it describes.
  178.  
  179. 
  180.  
  181. 
  182.  
  183. 1.3 (March 6, 1996)
  184.  
  185. ΓÇó  Public AWOL Utilities 1.3 release.
  186.  
  187. ΓÇó  Allowed menus and menu items to be specified using string parameters,
  188.  
  189. with or without the corresponding numeric ID parameters.  An error is
  190.  
  191. returned if the numeric and string parameters do not match.
  192.  
  193. ΓÇó  Added support for modifier keys (Shift, Control, Option, Command) in
  194.  
  195. the Query Menu event.
  196.  
  197. ΓÇó  Improved application compatibility by simulating a menu bar click, to
  198.  
  199. force the application to update its menus, before reading the contents of a
  200.  
  201. menu in response to a Query Menu or Select Menu Item event.
  202.  
  203. ΓÇó  Changed the response to a menu selection with the Caps Lock key down
  204.  
  205. to a simple Apple event recording action, instead of having the target
  206.  
  207. application send itself a Menu event to invite recording.
  208.  
  209. ΓÇó  Added an error string parameter to the reply event when an error
  210.  
  211. occurs.
  212.  
  213. ΓÇó  Moved the error codes from the -21000 range to the -15950 range, so
  214.  
  215. that errors are reported sensibly in AppleScript alerts.
  216.  
  217. ΓÇó  Rewrote ΓÇ£Menu Events Sample ScriptΓÇ¥ to make use of the new optional
  218.  
  219. string parameters.
  220.  
  221. 
  222.  
  223. 1.2 (October 17, 1994)
  224.  
  225. ΓÇó  Public AWOL Utilities 1.2 release.
  226.  
  227. ΓÇó  No revisions.
  228.  
  229. 
  230.  
  231. 1.1.2 (April 19, 1994)
  232.  
  233. ΓÇó  Added support for script recording by forcing high-level-event-aware
  234.  
  235. applications to send themselves Menu events when the user selects a
  236.  
  237. menu item and the Caps Lock key is down.
  238.  
  239. ΓÇó  Added support for modifier keys (Shift, Control, Option, Command) in
  240.  
  241. the Select Menu Item event.
  242.  
  243. ΓÇó  Removed the nonStandardMenuErr (-21004) code in favor of the new
  244.  
  245. keyMenuMDEFID parameter in the reply to the Query Menu List event, to
  246.  
  247. improve compatibility with target applications which use slightly
  248.  
  249. non-standard menu definition procedures.
  250.  
  251. 
  252.  
  253. 1.1.1 (April 11, 1994)
  254.  
  255. ΓÇó  Added ΓÇ£Menu Events Scripting AdditionΓÇ¥ and ΓÇ£Menu Events Sample
  256.  
  257. ScriptΓÇ¥ in place of ΓÇ£Menu Events 'aete'ΓÇ¥ resource file.
  258.  
  259. 
  260.  
  261. 1.1 (March 28, 1994)
  262.  
  263. ΓÇó  Public AWOL Utilities 1.1 release.
  264.  
  265. ΓÇó  Documented that Menu Events works with Finder 7.1.2.
  266.  
  267. 
  268.  
  269. 1.0.7 (March 13, 1994)
  270.  
  271. ΓÇó  Menu Events Help presents a useful message if the user tries to open or
  272.  
  273. print it when the help server is absent.
  274.  
  275. 
  276.  
  277. 1.0.6 (February 27, 1994)
  278.  
  279. ΓÇó  Added protection against loading duplicate copies of the extension.
  280.  
  281. 
  282.  
  283. 1.0.5 (February 6, 1994)
  284.  
  285. ΓÇó  Improved compatibility with At Ease and other applications which flush
  286.  
  287. mouse-down events when they become active.
  288.  
  289. 
  290.  
  291. 1.0.4 (January 30, 1994)
  292.  
  293. ΓÇó  If the Shift key is pressed on startup, the extension will not be loaded.
  294.  
  295. If the Help or Command-? key is pressed, the extension will delay up to
  296.  
  297. one second to let the user release the key(s).
  298.  
  299. 
  300.  
  301. 1.0.3 (January 19, 1994)
  302.  
  303. ΓÇó  Added ΓÇ£Menu Events 'aete'ΓÇ¥ resource file.
  304.  
  305. 
  306.  
  307. 1.0.2 (January 11, 1994)
  308.  
  309. ΓÇó  Fixed bug which sent the target application into a notification wait state
  310.  
  311. if it received a Menu event from a remote sender.
  312.  
  313. 
  314.  
  315. 1.0.1 (December 31, 1993)
  316.  
  317. ΓÇó  Initial AWOL Utilities 1.0.1 release.
  318.  
  319.